Modificar Imagenes en RMarkdown

R Markdown es una herramienta poderosa para crear documentos dinámicos. Una tarea común es incluir y ajustar imágenes. Esta guía te mostrará las mejores formas de hacerlo, desde la sintaxis básica hasta el control total usando chunks de R.

1. El Metodo Basico: Sintaxis de Mardown

La forma más simple de incluir una imagen es con la sintaxis estándar de Markdown. Es rápida y fácil, pero ofrece muy poco control sobre el resultado final.

gato marciano enojado
gato marciano enojado

Limitación principal: Con este método no puedes cambiar el tamaño, la alineación o añadir un pie de foto numerado de forma nativa.

2. El Metodo Recomendado Chunks de R y `knitr´

Para un control total, la mejor práctica es usar un chunk de código de R con la función knitr::include_graphics(). Esto te permite usar las opciones del chunk para modificar casi cualquier aspecto de la imagen.

¡Recuerda! Para que solo se muestre la imagen y no el código, siempre añade la opción echo=FALSE al encabezado del chunk.

Ajustar el Tamaño (Ancho y Alto)

Las opciones más comunes son out.width y out.height. Puedes usar porcentajes o píxel.

Este código mostrará la imagen a la mitad del ancho del contenedor del documento. También puedes usar valores fijos como “300px”.

Alinear la imagen

Usa la opción fig.align para alinear la imagen. Los valores posibles son ‘left’, ‘center’, y ‘right’.

Añadir un Pie de Foto (Caption)

Usa fig.cap para añadir un pie de foto descriptivo. R Markdown automáticamente numerará tus figuras (Ej: “Figura 1: …”).

Gato marciano enojado captado en camara.

Gato marciano enojado captado en camara.

Añadir Texto Alternativo (Accesibilidad)

El texto alternativo es leído por lectores de pantalla. Es fundamental para la accesibilidad. Usa la opción fig.alt.

Descripción detallada de la imagen para lectores de pantalla.

3. Ejemplo completo

Aquí tienes un ejemplo que combina todas las opciones más importantes en un solo chunk.

El logo hexagonal de RStudio con una R mayúscula en el centro.

Imagen de pinterest usado como ejemplo.